kotlin-stdlib/kotlin.collections/[Common]MutableList

MutableList

interface MutableList<E> : List<E> , MutableCollection<E>

A generic ordered collection of elements that supports adding and removing elements.

Parameters

the type of elements contained in the list. The mutable list is invariant in its element type.

Functions

add

abstract override fun add(element: E): Boolean

Adds the specified element to the end of this list.

abstract fun add(index: Int, element: E)

Inserts an element into the list at the specified index.

addAll

abstract override fun addAll(elements: Collection<E>): Boolean

Adds all of the elements of the specified collection to the end of this list.

abstract fun addAll(index: Int, elements: Collection<E>): Boolean

Inserts all of the elements of the specified collection elements into this list at the specified index.

clear

abstract override fun clear()

contains

abstract operator override fun contains(element: E): Boolean

containsAll

abstract override fun containsAll(elements: Collection<E>): Boolean

get

abstract operator fun get(index: Int): E

indexOf

abstract fun indexOf(element: E): Int

isEmpty

abstract override fun isEmpty(): Boolean

iterator

abstract operator override fun iterator(): Iterator<E>

lastIndexOf

abstract fun lastIndexOf(element: E): Int

listIterator

abstract override fun listIterator(): MutableListIterator<E>

abstract override fun listIterator(index: Int): MutableListIterator<E>

remove

abstract override fun remove(element: E): Boolean

removeAll

abstract override fun removeAll(elements: Collection<E>): Boolean

removeAt

abstract fun removeAt(index: Int): E

Removes an element at the specified index from the list.

retainAll

abstract override fun retainAll(elements: Collection<E>): Boolean

set

abstract operator fun set(index: Int, element: E): E

Replaces the element at the specified position in this list with the specified element.

subList

abstract override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Properties

size

abstract override val size: Int

Inheritors

AbstractMutableList

ArrayList

Extensions

asReversed

@JvmName(name = "asReversedMutable")

fun <T> MutableList<T>.asReversed(): MutableList<T>

Returns a reversed mutable view of the original mutable List. All changes made in the original list will be reflected in the reversed one and vice versa.

fill

expect fun <T> MutableList<T>.fill(value: T)

actual inline fun <T> MutableList<T>.fill(value: T)

Fills the list with the provided value.

actual fun <T> MutableList<T>.fill(value: T)

Fills the list with the provided value.

actual fun <T> MutableList<T>.fill(value: T)

Fills the list with the provided value.

remove

~~inline~~ ~~fun~~ <T> MutableList<T>.~~remove~~(~~index~~: Int): T

Removes the element at the specified index from this list. In Kotlin one should use the MutableList.removeAt function instead.

removeAll

fun <T> MutableList<T>.removeAll(predicate: (T) -> Boolean): Boolean

Removes all elements from this MutableList that match the given predicate.

removeFirst

fun <T> MutableList<T>.removeFirst(): T

Removes the first element from this mutable list and returns that removed element, or throws NoSuchElementException if this list is empty.

removeFirstOrNull

fun <T> MutableList<T>.removeFirstOrNull(): T?

Removes the first element from this mutable list and returns that removed element, or returns null if this list is empty.

removeLast

fun <T> MutableList<T>.removeLast(): T

Removes the last element from this mutable list and returns that removed element, or throws NoSuchElementException if this list is empty.

removeLastOrNull

fun <T> MutableList<T>.removeLastOrNull(): T?

Removes the last element from this mutable list and returns that removed element, or returns null if this list is empty.

replaceAll

fun <T> MutableList<T>.replaceAll(transformation: (T) -> T)

Replaces each element in the list with a result of a transformation specified.

retainAll

fun <T> MutableList<T>.retainAll(predicate: (T) -> Boolean): Boolean

Retains only elements of this MutableList that match the given predicate.

reverse

expect fun <T> MutableList<T>.reverse()

Reverses elements in the list in-place.

actual fun <T> MutableList<T>.reverse()

Reverses elements in the list in-place.

actual fun <T> MutableList<T>.reverse()

Reverses elements in the list in-place.

actual fun <T> MutableList<T>.reverse()

Reverses elements in the list in-place.

shuffle

fun <T> MutableList<T>.shuffle(random: Random)

Randomly shuffles elements in this list in-place using the specified random instance as the source of randomness.

expect fun <T> MutableList<T>.shuffle()

inline fun <T> MutableList<T>.shuffle(random: Random)

Randomly shuffles elements in this mutable list using the specified random instance as the source of randomness.

actual inline fun <T> MutableList<T>.shuffle()

Randomly shuffles elements in this mutable list.

actual fun <T> MutableList<T>.shuffle()

Randomly shuffles elements in this list.

actual fun <T> MutableList<T>.shuffle()

Randomly shuffles elements in this list.

sort

expect fun <T : Comparable<T>> MutableList<T>.sort()

~~inline~~ ~~fun~~ <T> MutableList<T>.~~sort~~(~~comparator~~: Comparator<in T>)

~~inline~~ ~~fun~~ <T> MutableList<T>.~~sort~~(~~comparison~~: (T, T) -> Int)

actual fun <T : Comparable<T>> MutableList<T>.sort()

Sorts elements in the list in-place according to their natural sort order.

actual fun <T : Comparable<T>> MutableList<T>.sort()

Sorts elements in the list in-place according to their natural sort order.

actual fun <T : Comparable<T>> MutableList<T>.sort()

Sorts elements in the list in-place according to their natural sort order.

sortBy

inline fun <T, R : Comparable<R>> MutableList<T>.sortBy(crossinline selector: (T) -> R?)

Sorts elements in the list in-place according to natural sort order of the value returned by specified selector function.

sortByDescending

inline fun <T, R : Comparable<R>> MutableList<T>.sortByDescending(crossinline selector: (T) -> R?)

Sorts elements in the list in-place descending according to natural sort order of the value returned by specified selector function.

sortDescending

fun <T : Comparable<T>> MutableList<T>.sortDescending()

Sorts elements in the list in-place descending according to their natural sort order.

sortWith

expect fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)

actual fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)

Sorts elements in the list in-place according to the order specified with comparator.

actual fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)

Sorts elements in the list in-place according to the order specified with comparator.